Description

Adds an only argument (an enum list) to some polymorphic relation fields (currently only those for lists/connections of "mode=union" interfaces). When present, only the given types will be included in the result.

Currently this is enabled by default but marked as experimental. Due to #1816 Ruru won't recognize the argument exists, but it's there so just write it and ignore the red squigglies. The enum values are the exact names of the types.

Example query:

{
  allApplications(only: [GcpApplication, AwsApplication]) {
    nodes {
      __typename
      ... on AwsApplication {
        awsId
      }
      ... on GcpApplication {
        gcpId
      }
      vulnerabilities(only: [ThirdPartyVulnerability]) {
        nodes {
          __typename
          id
          name
          ... on FirstPartyVulnerability {
            teamName
          }
          ... on ThirdPartyVulnerability {
            vendorName
          }
        }
      }
    }
  }
}

Performance impact

Plan-time only.

Security impact

None known.

Checklist

• My code matches the project's code style and yarn lint:fix passes.
• I've added tests for the new feature, and yarn test passes.
• I have detailed the new feature in the relevant documentation.
• I have added this feature to 'Pending' in the RELEASE_NOTES.md file (if one exists).
• If this is a breaking change I've explained why.